home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
FishMarket 1.0
/
FishMarket v1.0.iso
/
fishies
/
051-075
/
disk_069
/
asm68k
/
mini.docs
< prev
next >
Wrap
Text File
|
1992-05-06
|
5KB
|
121 lines
Asm68k 68000 Macro Assembler
Version 1.0.3
Mini-Docs
(This file contains only relevant portions covering changes from version 1.0.2.
The Assembler was released with a full set of updated docs as a separate file,
and should be redistributed with them available.)
Date: 24-Apr-87
NOTICE:
THIS FILE AND THE PROGRAM IT DESCRIBES ARE COPYRIGHT © 1987,
W. WESLEY HOWE. ALL RIGHTS RESERVED. A LICENSE FOR USE AND
DISTRIBUTION WITHOUT PROFIT IS GRANTED TO POSSESSOR OF THIS FILE.
NO RIGHT OF ALTERATION OF THE PROGRAM OR DOCUMENTATION IS CONVEYED
WITH THIS LICENSE.
NO WARRANTY IS EXPRESSED OR IMPLIED HEREIN ON THE SUITABILITY
OF THIS PROGRAM FOR ANY PURPOSE AT ALL. YOU MUST RELY ON YOUR OWN
JUDGEMENT AS TO WHETHER THIS PROGRAM WILL OPERATE PROPERLY WITH
YOUR COMPUTER FOR WHATEVER PURPOSE YOU MAY DESIRE TO USE IT FOR.
ADDRESS ALL QUESTIONS, COMMENTS OR CRITICISM TO:
WESLEY HOWE
4800 LAKEMONT DR.
RALEIGH, NC 27609
(I may also be found at the Software Distillery's board (919) 471-6436,
MMS at (919) 779-6674 or (919) 772-9176 or (919) 779-5059, or ocassionally
on PLink (OPS833) and CIS (73277,260), although my appearances at the
last two are more erratic.)
=============================================================================
LIMITS:
Available RAM: 1,056,768 bytes maximum heap utilized
Program size: 78,024 bytes (loaded)
Minimum free heap: 28,162 bytes
Total RAM necessary: 106,186 bytes
Operating System: AmigaDOS 1.2 (CLI Only)
==============================================================================
Expressions:
Program Counter: The symbol * can be used as shorthand for the current
PC (relative offset) under the following criteria:
1> It is the FIRST (or only) character in an expression or
2> It is the second half of a binary operator (i.e. after
a valid math operator, with or without parentheses.)
Expressions that use the * or any symbol that refers to a relative
or external operation may only use plus and minus for math operations.
Any combinations within an expression that result in a value that will
not always generate reliable usage of relative locations will be flagged
with an expression error message.
==============================================================================
Macros:
One additional feature within Macros is the \@ (backslash followed by the
at character). While the Macro is being expanded, this combination is changed
to a period followed by three decimal digits. These digits increment starting
from zero every time a macro call is made that uses the \@ combination, and
will be used for the duration of that macro (a contained macro call will use a
new number, then when it ends the former macro's number will be used until it
ends. This allows unique symbol names to be generated within the Macro text,
allowing branch instructions to occur. Local (numeric) Labels are effective
within the Macro, but they do not attach to the Macro name, nor are they
canceled by the Macro invocation (unless the invocation line was labeled.) Note
that this sequence is significantly different from the usage in version 1.0.1.
===============================================================================
Release History:
Version 1.0.1 Alpha1.........released 02-Jan-87.
Version 1.0.1 Beta1..........released 11-Jan-87.
Version 1.0.1 Beta2..........released 20-Jan-87.
Version 1.0.1................released 28-Feb-87.
Version 1.0.2................released 14-Apr-87.
Version 1.0.3................released 24-Apr-87.
Changes: 1. Error messages no longer are generated in the case
of EXTERN or ENTRY type multiple definitions.
More precisely, the second or subsequent usage is
ignored.
2. The counter for \@ has been changed so that it is
not incremented unless it is used by a macro. In
version 1.0.2, each macro call incremented the
counter, causing overflow in large source files
before 999 uses. This change should not cause the
need for source changes in files that assembled
correctly under the previous release, although a
reassembly will have different values used.
3. The expression evaluator has been changed slightly
on the rules regarding the use of the '*' op for
the PC location. This corrects prior problems in-
volving the assembler confusing the two uses that
made multiplication fail.
4. Labels and symbols that begin with a period will
now be recognized within expressions.
===============================================================================
A special note of gratitude to various members of ASDF (Amiga Software
Developers Forum), The Software Distillery (whose BLink reduced the many
hours spent relinking the source files during development), and especially
John Toebes, whose offhand remarks unknowingly provided much of the inspiration
to keep going. Also DJ JAMES and KEN S for their work in running down some
of the problems I missed.
===============================================================================
<*|=|*> THE END <*|=|*>
==============================================================================